home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 001-100 / 001-025 / 004 / bgrep / bgrep.man < prev    next >
Text File  |  1995-03-17  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4.      BBBBGGGGRRRREEEEPPPP((((1111))))             UUUUNNNNIIIIXXXX 5555....0000 ((((GGGGeeeeoooorrrrggggiiiiaaaa TTTTeeeecccchhhh))))             BBBBGGGGRRRREEEEPPPP((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           bgrep - search a file for one or more simple strings
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           bbbbggggrrrreeeepppp [ options ] string-list [ files ]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           _B_g_r_e_p (Boyer-Moore grep) is program patterned after
  16.           _f_g_r_e_p(1).  It uses the Boyer-Moore string searching
  17.           algorithm, which actually gets faster as the length of the
  18.           pattern to be searched for increases.  _B_g_r_e_p searches for
  19.           plain _s_t_r_i_n_g_s (separated by newlines in the _s_t_r_i_n_g-_l_i_s_t
  20.           argument), not regular expressions in the style of _g_r_e_p.
  21.  
  22.           The following _o_p_t_i_o_n_s are recognized:
  23.  
  24.           ----vvvv   All lines but those matching are printed.
  25.  
  26.           ----xxxx   (Exact) only lines matched in their entirety are
  27.                printed.
  28.  
  29.           ----cccc   Only a count of the matching lines are printed.  This
  30.                is the total count, across all the input files.
  31.  
  32.           ----iiii or ----yyyy
  33.                Ignore case when trying to match a line.  Both versions
  34.                of this option are accepted for compatibility with _g_r_e_p
  35.                on different versions of Unix.
  36.  
  37.           ----llll   Only the names of files with matching lines are printed
  38.                (once), separated by newlines.
  39.  
  40.           ----nnnn   Each line is preceded by its relative line number
  41.                within the file.
  42.  
  43.           ----ssss   Silent mode:  No output is generated (except error
  44.                messages).  This is useful for just checking the exit
  45.                status.
  46.  
  47.           ----eeee _s_t_r_i_n_g
  48.                Same as a simple _s_t_r_i_n_g argument, but useful when the
  49.                string begins with a -.
  50.  
  51.           ----ffff _f_i_l_e
  52.                The strings to be searched for are read from _f_i_l_e.
  53.  
  54.           The arguments to the ----eeee and ----ffff options _m_u_s_t be given as
  55.           separate program arguments, i.e. separated by white space.
  56.  
  57.           _B_g_r_e_p catches conflicting arguments (e.g.  ----vvvv and ----xxxx) and
  58.           complains.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 1/1/86)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      BBBBGGGGRRRREEEEPPPP((((1111))))             UUUUNNNNIIIIXXXX 5555....0000 ((((GGGGeeeeoooorrrrggggiiiiaaaa TTTTeeeecccchhhh))))             BBBBGGGGRRRREEEEPPPP((((1111))))
  71.  
  72.  
  73.  
  74.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.           _e_d(1), _s_e_d(1), _g_r_e_p(1), _s_h(1)
  76.  
  77.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  78.           Exit status 0 if any matches were found, 1 if none, 2 for
  79.           syntax errors on the command, or if any files could not be
  80.           opened (even if matches were found).
  81.  
  82.      BBBBUUUUGGGGSSSS
  83.           Input lines and the strings to be searched for are limited
  84.           to 256 characters.  Longer input lines are truncated.
  85.  
  86.           _B_g_r_e_p will not search for any more than 120 different
  87.           strings.
  88.  
  89.           Uses the <stdio.h> package, which slows it down some.
  90.           Nonetheless, in the usual case, it is 10% to 20% faster than
  91.           _f_g_r_e_p(1).
  92.  
  93.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  94.           Roy Mongiovi (gatech!gitpyr!roy) coded the guts of the
  95.           Boyer-Moore algorithm, while Arnold Robbins (gatech!arnold)
  96.           wrote the code to do all the rest of the work, and the man
  97.           page.
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 1/1/86)
  130.  
  131.  
  132.  
  133.